home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / util1 / dsktrk82.zip / DISKTRKD.DOC next >
Text File  |  1993-01-10  |  72KB  |  1,481 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                   DiskTrak for DOS
  12.  
  13.                                     Version 8.22
  14.  
  15.                                   DiskTrak for DOS
  16.                                     Version 8.22
  17.  
  18.  
  19.                                   Table of Contents
  20.  
  21.  
  22.  
  23.      Table of Contents . . . . . . . . . . . . . . . . . . . . . . . . . . .   2
  24.  
  25.      Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  26.  
  27.      Installation  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  28.  
  29.      For Users of the DOS DiskTrak Version 7.xx Program  . . . . . . . . . .   5
  30.  
  31.      System Requirements, Compatibility, and Limitations . . . . . . . . . .   6
  32.  
  33.      Using the Program . . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  34.  
  35.      The Window Focus  . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  36.  
  37.      Shortcut keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  38.  
  39.      Using the Button Box Push Buttons . . . . . . . . . . . . . . . . . . .   9
  40.  
  41.      FILE  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  10
  42.           Open a Database  . . . . . . . . . . . . . . . . . . . . . . . . .  10
  43.           DOS Shell  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  44.           Exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  45.  
  46.      ACTION  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  47.           Add/Update Disk(s) . . . . . . . . . . . . . . . . . . . . . . . .  11
  48.           Add/Edit Comments  . . . . . . . . . . . . . . . . . . . . . . . .  12
  49.           Report to Screen . . . . . . . . . . . . . . . . . . . . . . . . .  13
  50.           Report to File . . . . . .
  51.  
  52.                                   DiskTrak for DOS
  53.                                     Version 8.22
  54.  
  55.  
  56.      CONFIGURATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  57.           OK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  58.           Save . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  59.           Data Disk Drive  . . . . . . . . . . . . . . . . . . . . . . . . .  20
  60.           ZIP Extract  . . . . . . . . . . . . . . . . . . . . . . . . . . .  21
  61.           Print Lines/Page . . . . . . . . . . . . . . . . . . . . . . . . .  21
  62.           Report Type  . . . . . . . . . . . . . . . . . . . . . . . . . . .  21
  63.           Screen Colors  . . . . . . . . . . . . . . . . . . . . . . . . . .  22
  64.  
  65.      HELP  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  23
  66.           Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  23
  67.           About  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  23
  68.  
  69.      Future Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . .  23
  70.  
  71.      The DiskTrak for DOS Database . . . . . . . . . . . . . . . . . . . . .  23
  72.  
  73.      Version History . . . . . . . . . . . . . . . . . . . . . . . . . . . .  24
  74.           Version 8.00 . . . . . . . . . . . . . . . . . . . . . . . . . . .  24
  75.  
  76.      Potential Future Enhancements . . . . . . . . . . . . . . . . . . . . .  25
  77.  
  78.      Un-Planned Enhancements . . . . . .
  79.  
  80.                                   DiskTrak for DOS
  81.                                     Version 8.22
  82.  
  83.  
  84.                                     Introduction
  85.  
  86.      DiskTrak for DOS was designed to provide a "quick and easy" method for
  87.      keeping track of diskette collections.  DiskTrak for DOS will allow you to
  88.      easily create a database that contains a list of all your diskettes and the
  89.      files and free space available on each one.  Optionally, you can include a
  90.      comment or description for each file on each diskette.  Also, you can have
  91.      DiskTrak for DOS extract the names of files stored inside  "ZIP", "PAK",
  92.      "ARC", "ZOO", and "LZH" archive files (and you can create comments for
  93.      these files as well.)  Then, anytime you want to locate the disk containing
  94.      a particular file, simply enter the filename into DiskTrak for DOS and it
  95.      will tell you the disk (or disks, if there are more than one) that holds
  96.      the file you're looking for.  If you don't know the complete name of the
  97.      file, key in as much of it as you do know and DiskTrak for DOS will search
  98.      its database for all disks containing any file that has the partial name
  99.      you entered embedded in it.   DiskTrak for DOS supports this same database
  100.      search capability for disk names and file comments as well, so if you enter
  101.      descriptive comments for your file names, DiskTrak for DOS allows you to
  102.      find the file based on its comment.
  103.  
  104.      DiskTrak for DOS also has other useful disk and file related capabilities:
  105.      it can label and re-label diskettes, identify duplicate files,  delete
  106.      and/or restore files, and produce 5 types of hard and/or soft copy reports
  107.      of its database contents.  Finally, DiskTrak for DOS supports several
  108.      "usability" functions such as screen color customization, database
  109.      maintenance, and DOS Shell functionality.
  110.  
  111.      Creating and maintaining DiskTrak for DOS databases is easy.  After
  112.      creating a database (see the Make a Database section below for details),
  113.      use the File Open function to open it and then simply "feed" your diskettes
  114.      to DiskTrak for DOS.  The program will read the directories and
  115.      subdirectories on each diskette, extract all filenames (including hidden
  116.      and system files) and the amount of free space, and automatically update
  117.      its database.  If you add or delete files on a diskette, simply "re-feed"
  118.      it into DiskTrak for DOS; the database will be automatically updated. 
  119.  
  120.      DiskTrak for DOS is distributed as "shareware", meaning it is allowed to be
  121.      freely copied and distributed, but if used on a regular basis, must be paid
  122.      for.  If you continue to use DiskTrak for DOS you are obligated to send its
  123.      registration fee ($25.00) to Peninsula Software.  The ASCII text file
  124.      REGISTER.TXT is provided to make it more convenient to register your
  125.      shareware.  Note that Peninsula Software will also accept Visa
  126.      and MasterCard orders.
  127.  
  128.      Upon receipt of your registration fee, Peninsula Software will mail you a
  129.      3.5" 720K diskette (or two 5.25" 360K diskettes) containing a copy of the
  130.      most current version of DiskTrak for DOS that is registerted to you
  131.      exlusively.  Registered versions of DiskTrak for DOS do not contain the
  132.      "Registration Motivator" dialog box, and also display the name of the
  133.      registered user in the "About"  window.  Finally, registering will allow
  134.      Peninsula Software to continue further enhancements to DiskTrak for DOS
  135.      (many features in the current version were suggested by registered users)
  136.      and to develop other low cost software products. 
  137.  
  138.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  139.                                         4
  140.  
  141.                                   DiskTrak for DOS
  142.                                     Version 8.22
  143.  
  144.  
  145.      The following sections describe how to install DiskTrak for DOS and how to
  146.      use the program.  After that is a description of each menu selection. 
  147.      Finally, there is a brief discussion of the DiskTrak for DOS database and a
  148.      summary of the changes made to DiskTrak for DOS since version 8.00.
  149.  
  150.  
  151.                                     Installation
  152.  
  153.      Installing DiskTrak for DOS is a simple process:
  154.  
  155.      (1) Copy the files DISKTRKD.EXE, SAMPLE.DTW, DISKTRKD.IDX, and DISKTRKD.HLP
  156.      to the directory from which you wish to run DiskTrak for DOS.  DISKTRKD.EXE
  157.      is the DiskTrak program, and SAMPLE.DTW is a sample database you can use
  158.      for testing/evaluation.  DISKTRKD.IDX and DISKTRKD.HLP are, respectively,
  159.      the topic index and text for the program's online Help function.
  160.  
  161.      (2) Start DISKTRKD like any standard DOS application.
  162.  
  163.      DiskTrak for DOS will  use the file SAMPLE.DTW as a "demonstration"
  164.      database.  You can use this database to try out all of the DiskTrak for DOS
  165.      functions, including making updates and deletes, before you create your own
  166.      database.  Later, when you're familiar with how DiskTrak for DOS works,
  167.      create your own database, verify that it works properly, and delete
  168.      SAMPLE.DTW.  (Note -- when you do this BE SURE to first create a DiskTrak
  169.      for DOS configuration file identifying your database as the one DiskTrak
  170.      for DOS should use.  See the section "Config. Save" below for details on
  171.      how to do this.)
  172.  
  173.  
  174.                  For Users of the DOS DiskTrak Version 7.xx Program
  175.  
  176.      Beginning with DiskTrak for DOS Version 8.00, DiskTrak for DOS uses a
  177.      database format different from that used by the DOS version 7.xx
  178.      DISKTRAK.EXE program.  In fact, the database format used by DiskTrak for
  179.      DOS Version 8.00 (or later) is exactly the same as that used by the Windows
  180.      version of DiskTrak.  Consequently, all DiskTrak for DOS database files
  181.      must have a name of the form <name>.DTW.  Databases used by DiskTrak for
  182.      DOS prior to Version 8.00 are all named <name>.DT7.  If you have a database
  183.      of this form and you want to convert it for use by DiskTrak for DOS Version
  184.      8.00 (or later), simply copy each of your <name>.DT7 database files to
  185.      <name>.DTW.  Then, when opened by DiskTrak for DOS, you will be asked if
  186.      you want to convert the database to the format required by DiskTrak for
  187.      DOS.  Replying "Yes" will invoke an automatic database conversion routine
  188.      that will convert your copied database into the format required by this
  189.      version of DiskTrak for DOS.
  190.  
  191.      Because they contain no directory information, when pre-Version 8.00
  192.      DiskTrak for DOS databases are converted to the current database format,
  193.      all filenames are assumed to be in the diskette's root directory.  However,
  194.      if a file with a comment is actually in a subdirectory, its comment will be
  195.      lost when that diskette is updated by the current version of DiskTrak for
  196.      DOS.  Losing a comment for a file in a subdirectory occurs because DiskTrak
  197.      for DOS Version 8.00 (and later) sees files from earlier version's
  198.  
  199.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  200.                                         5
  201.  
  202.                                   DiskTrak for DOS
  203.                                     Version 8.22
  204.  
  205.  
  206.      databases as being in the root directory (based on the contents of the
  207.      unconverted database), but when updating the diskette determines the file
  208.      is  actually in a subdirectory.  Thus, it is not recognized as being the
  209.      same file and the comment is not carried forward into the updated database. 
  210.      This logic is necessary because DiskTrak for DOS must allow for duplicate
  211.      named files to exist in different directories on the same diskette, and for
  212.      each to have its own unique comment.
  213.  
  214.      The net result of this is that users of versions of DiskTrak for DOS prior
  215.      to Version 8.00 who have entered comments for files in diskette
  216.      subdirectories will have to re-enter them if, and when, they update those
  217.      diskettes with the current version of DiskTrak for DOS.
  218.  
  219.  
  220.                  System Requirements, Compatibility, and Limitations
  221.       
  222.      Beginning with Version 8.00 of DiskTrak for DOS, a mouse or other pointing
  223.      device is highly desired to facilitate selecting the various screen
  224.      elements displayed by the program.  Though a mouse or pointing device is
  225.      not absolutely required, program operation without one is less efficient
  226.      because some screen elements cannot be selected directly, but must be
  227.      tabbed to in a fixed order, or selected using access key combinations.
  228.  
  229.      As a DOS application, DiskTrak for DOS is limited by the DOS requirement
  230.      that all data and program code use no more than 640K of RAM memory. 
  231.      Consequently, on a typical system with 640K or RAM, databases should not
  232.      exceed 2500 file names (approximately.)  Additionally, DiskTrak for DOS is
  233.      limited by the Visual Basic constraint of no more than 64K of data for a
  234.      list box (which is what DiskTrak for DOS uses to display its data on
  235.      screen.)  Consequently, although you can make a DiskTrak for DOS database
  236.      arbitrarily large, DiskTrak for DOS may not be able to display it all, or
  237.      to produce a print or file report containing it all.  In these cases
  238.      DiskTrak for DOS will issue an error message.  Sometimes, however, DiskTrak
  239.      for DOS may not be able to properly detect an out of memory condition and
  240.      will abort.  In these cases, you should consider using multiple, smaller,
  241.      databases.
  242.  
  243.  
  244.                                   Using the Program
  245.  
  246.      When DiskTrak for DOS starts, several things happen automatically:
  247.  
  248.      (1) If you are using an unregistered version of the program, a Registration
  249.      Motivator dialog box is displayed requiring you to enter the word
  250.      "register".  This step does not occur with a registered copy of the
  251.      program.
  252.  
  253.      (2) The program looks for its configuration file (named DISKTRKD.CFG) and
  254.      reads from it the name of the startup database and various other program
  255.      values (e. g., the color specifications, data disk drive, ZIP option, etc.) 
  256.      If the file DISKTRKD.CFG is not accessible, the default database name
  257.      SAMPLE.DTW is assumed, along with default values for all other items.
  258.  
  259.  
  260.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  261.                                         6
  262.  
  263.                                   DiskTrak for DOS
  264.                                     Version 8.22
  265.  
  266.  
  267.      Note:  use the Configuration -- Configuration Save option described below
  268.      to create DISKTRKD.CFG.
  269.  
  270.      (3) The program opens the startup database, reads the data in it, and
  271.      displays the main menu screen reflecting the data in the database and the
  272.      current program values.  If it is unable to open the startup database, the
  273.      problem may be that it is a database from an earlier version of DiskTrak
  274.      that requires conversion to the current format.  In this case the program
  275.      displays a dialog box asking if you want to convert.  If you select yes,
  276.      the database is converted to the new format, and the old database is saved
  277.      in a file whose name is <name>.DTZ.  If no is selected, the program opens
  278.      the Main Menu, but with no database selected.
  279.  
  280.  
  281.      The following diagram shows the Main Menu command line and all sub-
  282.      commands:
  283.  
  284.      File          Action            Search     Utilities Configuration Help
  285.  
  286.      Open Database Add/Update Disks  Filename   Compress Database       Help
  287.      Dos Shell     Add/Edit Comments Comment    Expand Database         About
  288.      Exit          Report to Screen  Diskname   Make a Database
  289.                    Report to File    Dupe Files Sort by Name
  290.                    Report to Print   Cancel     Sort by Free Space
  291.                    Restore Files      Search    Show Free Space
  292.                    Delete Disks        Results
  293.                    Delete Files
  294.                    Label Disks
  295.  
  296.      In addition to the command line, the DiskTrak for DOS display contains
  297.      seven windows for presenting information.  In clockwise order, starting
  298.      from the upper left, these are:
  299.  
  300.      (1) The disk list window, showing all disks in the current database, the
  301.      amount of free space on each, and the number of files on each.
  302.  
  303.      (2) The file list window, showing all of the files for the disk that is
  304.      currently selected in the disk list window.  The characters <C> after a
  305.      filename in the file list window indicate the file has a comment.
  306.  
  307.      (3) The DiskTrak Messages window, where DiskTrak displays messages about
  308.      its current operation or status.  Initially, this window is blank.
  309.  
  310.      (4) The button box window that contains "push buttons" capable of selecting
  311.      program functions.  This window does double duty by also showing
  312.      information about the current status of DiskTrak for DOS and its database. 
  313.  
  314.      (5) The Comments window, where the comment text is displayed for a file
  315.      that is selected in the file list window (assuming that file has a
  316.      comment.)  If  you selected the  Add/Edit Comment function, this window is
  317.      where you enter/edit comment text.
  318.  
  319.      (6) The Date/Time window that displays the date and time stamp of the file
  320.  
  321.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  322.                                         7
  323.  
  324.                                   DiskTrak for DOS
  325.                                     Version 8.22
  326.  
  327.  
  328.      currently selected in the file list window.  This window will be blank for
  329.      files in databases converted from an earlier version of DiskTrak for DOS,
  330.      and for files whose names are extracted from archive files. 
  331.  
  332.      (7) The Directory window that displays the diskette directory containing
  333.      the file currently selected in the file list window.  For diskettes having
  334.      all files in their root directories, this will be the "\" character only. 
  335.      No directory data is available for files converted from earlier versions of
  336.      DiskTrak for DOS, or for files whose names are extracted from archive
  337.      files.
  338.  
  339.  
  340.                                   The Window Focus
  341.  
  342.      The "Window focus" identifies which screen item will receive input or will
  343.      be used to make a selection.  A screen element "has the focus" when it is
  344.      highlighted or contains the video cursor.  For example, to display the 
  345.      files for a particular disk listed in the disk list window, you must first
  346.      select the disk name.  Doing this is a two step process: (1) causing the
  347.      disk list window to "get the focus", and (2) selecting the desired list
  348.      entry (in this case, disk name.)  In general, you can change the focus to
  349.      different screen objects using one of three techniques:
  350.  
  351.      (1) by pressing the Access Key combination of the screen item you wish to
  352.      have the focus.  A screen item's Access Key combination is the Alt key plus
  353.      the highlighted letter in the item's identifier.  For example, the file
  354.      list's access key is Alt + i.
  355.  
  356.      (2) by using the Tab key to move the focus from one object to the next,
  357.  
  358.      (3) by single-clicking it (the object you want to have the focus) with your
  359.      mouse or pointing device.  
  360.  
  361.      Once you have caused the desired screen element to have the focus, you
  362.      select the desired item by highlighting it using the keyboard direction
  363.      keys (arrow, home, end, pgup, pgdn) or by using your mouse, and then
  364.      selecting it by double clicking you mouse or pointing device, or pressing
  365.      the Enter key.
  366.  
  367.  
  368.                                   Shortcut keys
  369.  
  370.      DiskTrak for DOS supports a capability called Shortcut Keys that allows you
  371.      to invoke selected DiskTrak for DOS functions by simply pressing a single
  372.      key combination; you do not have to select any menu items at all.  As a
  373.      result, you can make selections more quickly by not having to access the
  374.      main menu command line.  Note that using shortcut keys is optional; all of
  375.      the functions in DiskTrak for DOS can be invoked using standard menu
  376.      techniques alone.
  377.  
  378.      Using shortcut keys with DiskTrak for DOS requires knowing which screen
  379.      object has the focus because there are some situations where the same
  380.      shortcut key is used for different functions.  For instance, the Del
  381.  
  382.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  383.                                         8
  384.  
  385.                                   DiskTrak for DOS
  386.                                     Version 8.22
  387.  
  388.  
  389.      (Delete) key will invoke the Delete Disk function if the disk list window
  390.      has the focus, but will invoke the Delete File function if the file list
  391.      window has the focus.
  392.  
  393.      The following table lists all of the DiskTrak for DOS functions that can be
  394.      invoked by shortcut keys, the focus item required, and the key combination
  395.      to use.
  396.  
  397.      Function            Focus Item          Shortcut Key Combination
  398.      -----------------   ----------------    ------------------------
  399.      Add/Update Disks    Disk List window    Ins (Insert)
  400.      Add/Edit Comments   File List window    Ins (Insert)
  401.      Delete Disks        Disk List window    Del (Delete)
  402.      Delete Files        File List window    Del (Delete)
  403.      Restore Files       File List window    Ctrl + R
  404.      Label Disks         Disk List window    Ctrl + L
  405.      Sort Disknames      Disk List window    Ctrl + N
  406.        by Name
  407.      Sort Disknames      Disk List window    Ctrl + F
  408.        by Free Space
  409.      Report to Screen    Disk List window    Ctrl + S
  410.      Report to File      Disk List window    Ctrl + I
  411.      Report to Print     Disk List window    Ctrl + P
  412.  
  413.      Note that (1) each DiskTrak for DOS menu item that can be invoked by a
  414.      shortcut key shows, on its menu "pull down", the shortcut key combination
  415.      in parentheses to the right of the function name, and (2) the shortcut key
  416.      is not always the same as the menu item "selection letter" that is
  417.      highlighhted in the menu function name.  (Remember, you can use the
  418.      selection letter key to selct a menu function once its menu is in view.)
  419.  
  420.  
  421.                           Using the Button Box Push Buttons
  422.  
  423.      The button box window contains eight items, six of which are "push buttons"
  424.      which can invoke program functions.  The other two items are text buttons
  425.      that display program information but are not selectable.  The text buttons
  426.      display the size of the current database and the number of diskettes you
  427.      have entered into the database.
  428.  
  429.      The six push buttons are dual-function; they display current program
  430.      information, and also invoke program functions when selected (clicked). 
  431.      Each function is also selectable via a main menu "pull-down", all of which
  432.      are described in the following sections of this document.  However, here is
  433.      a brief summary of each button:
  434.  
  435.           The Data Drive button displays the current diskette drive DiskTrak for
  436.           DOS will use.  When clicked, this button changes the drive to the next
  437.           one (left button clisk) or previous one (right button click.)  This
  438.           function is also available by selecting the Configuration menu item. 
  439.           You must have a mouse or other pointing device to select this button.
  440.  
  441.           The Database button displays the current database name.  When clicked,
  442.  
  443.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  444.                                         9
  445.  
  446.                                   DiskTrak for DOS
  447.                                     Version 8.22
  448.  
  449.  
  450.           invokes the Open Database function.  This function is also available
  451.           by selecting  "Open a Database" under the File menu item.
  452.  
  453.           The ZIP button displays the current status of the ZIP extract
  454.           function.  When clicked, changes (toggles) the ZIP function between
  455.           off and on.  This function is also available by selecting the
  456.           Configuration menu item.
  457.  
  458.           The Free button displays the percentage of free space in the current
  459.           database.  When clicked, invokes the database compress function which
  460.           is also available by selecting "Compress Database" under the Utilities
  461.           menu item.
  462.  
  463.           The Edit button displays the current status of the Comment Text edit
  464.           function.  When clicked, changes (toggles) the Comment Add/Edit
  465.           function between off and on.  This function is also available by
  466.           selecting "Add/Edit Comments" under the Action menu item (or by using
  467.           its shortcut key.)
  468.  
  469.           The Max button displays the maximum size (number of disks) the current
  470.           database can hold.  When clicked, invokes the Expand Database function
  471.           which is also available by selecting "Expand Database" under the
  472.           Utilities menu item.
  473.  
  474.      The following paragraphs describe the function of each of the menu options
  475.      and, as appropriate, the corresponding operational techniques you should
  476.      use to  optimize your use of DiskTrak for DOS.
  477.  
  478.      FILE
  479.  
  480.      -- Open a Database --
  481.  
  482.      Displays a dialog box allowing you to select the drive and directory from
  483.      which to select DiskTrak for DOS databases.  Note that the data base
  484.      filename pattern is set to *.DTW and cannot be changed.   Change the
  485.      displayed drive and/or directory by selecting it and pressing the Enter
  486.      key, or by double clicking it.
  487.  
  488.      This function can also be invoked by selecting the Database: button in the
  489.      main menu button box.
  490.  
  491.      After DiskTrak for DOS opens the selected database, it fills in the disk
  492.      list window and the program information window.  The disk list window
  493.      contains three columns of data: the diskette name, the amount of free space
  494.      it has, and the number of files on the diskette.  (Free space is displayed
  495.      as xxxK, where K = 1000 bytes, or as xxxM, where M = 1,000,000 bytes.)  To
  496.      see the names of the files on any particular diskette, simply select the
  497.      diskette's name and DiskTrak for DOS will fill the file list window with
  498.      the names of the files it contains.  You can scroll through the disk names
  499.      and file names using the mouse or the Up/Down, PgUp/ PgDn, and Home/End
  500.      keys.  File names for which you have added comments have the characters
  501.      "<C>" after their names.  (See the Action  Add/Edit Comments section for
  502.      how to create comments.)  Selecting a file name causes its date and  time
  503.  
  504.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  505.                                         10
  506.  
  507.                                   DiskTrak for DOS
  508.                                     Version 8.22
  509.  
  510.  
  511.      stamp data to appear in the Date/Time text box, and  its diskette directory
  512.      name to appear in the Directory text box.  If the file has a comment, it is
  513.      displayed in the Comment box.
  514.        
  515.  
  516.      -- DOS Shell --
  517.  
  518.      Selecting this option causes DiskTrak for DOS to start a "child" DOS shell. 
  519.      This means DiskTrak for DOS will appear to end and return control to DOS. 
  520.      In fact, DiskTrak for DOS is still active (in your computer's memory), but
  521.      has invoked the DOS command processor allowing you to issue any command you
  522.      would when running under DOS alone.  From the DOS shell you can copy files,
  523.      initialize disks, invoke other programs, etc.  However, you MUST remember
  524.      to return to DiskTrak for DOS by entering the command "Exit" when you have
  525.      finished with your DOS functions. 
  526.  
  527.      Note:  when in the DOS shell, do not move, rename, or otherwise disturb the
  528.      DiskTrak for DOS database or configuration file.  Changes made to these
  529.      files while in the DOS shell would be unknown to DiskTrak for DOS, and
  530.      unpredictable (probably bad) results would occur when DiskTrak for DOS
  531.      resumes.
  532.  
  533.                               
  534.      -- Exit --
  535.  
  536.      Selecting this option ends DiskTrak for DOS and returns you to the standard
  537.      DOS prompt. As the closing screen indicates, if you use DiskTrak for DOS on
  538.      a regular basis you are obligated to send the $25.00 (US) registration fee
  539.      to Peninsula Software.
  540.  
  541.  
  542.      ACTION
  543.  
  544.  
  545.      -- Add/Update Disk(s) --
  546.  
  547.      Shortcut key: Ins (Insert)
  548.  
  549.      Selecting this option allows you to enter diskettes into the DiskTrak for
  550.      DOS database.  The diskettes you enter can be either new diskettes, i. e.,
  551.      ones not currently in the database, or a re-entering (called a "refresh")
  552.      of a diskette currently in the database.  After selecting this option
  553.      DiskTrak for DOS will ask you to insert the diskette into the Data Disk
  554.      Drive and press Enter when ready.  DiskTrak for DOS will then attempt to
  555.      read the diskette's internal label (sometimes called the volume ID.)  If
  556.      there is no internal label, DiskTrak for DOS will ask you to enter one. 
  557.      This label will be used by DiskTrak for DOS to identify the diskette in its
  558.      database and will also be automatically written onto the diskette.  (See
  559.      the Label Disk section below for details on the labeling process.) 
  560.      DiskTrak for DOS will then check to see if the diskette is already
  561.      contained in the database.  If not, DiskTrak for DOS will read all the
  562.      filenames in each directory on the disk, alphabetically sort each
  563.      directory's filenames, and store them in the database.  It also stores the
  564.  
  565.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  566.                                         11
  567.  
  568.                                   DiskTrak for DOS
  569.                                     Version 8.22
  570.  
  571.  
  572.      total amount of free space on the disk in the database.  If you specified
  573.      the "ZIP" option to be enabled, DiskTrak for DOS will extract all filenames
  574.      from inside archive files of type ZIP, PAK, ARC, LZH, or ZOO. 
  575.  
  576.      If the diskette is already in the DiskTrak for DOS database you will be
  577.      asked if you want to proceed and "refresh" the database information. 
  578.      Normally you will want to do this, because (presumably) you have added or
  579.      deleted files from the diskette, and you want its current status reflected
  580.      in the DiskTrak for DOS database.  However, if you have inadvertently
  581.      created two different diskettes with the same name, you can abort the
  582.      Add/Update function at this time, relabel the diskette, and proceed again.
  583.  
  584.      DiskTrak for DOS will process only normally formatted DOS diskettes, and
  585.      will reject an unformatted diskette, or a diskette with a non-standard
  586.      format, such as those created by some hard disk backup programs.  
  587.  
  588.      Usage hint: you can invoke the Add/Update function by simply pressing the
  589.      Ins (Insert) key any time the disk list window has the current focus. 
  590.      Doing this is quicker than selecting the Add/Update function from the
  591.      Action menu item.
  592.  
  593.  
  594.      -- Add/Edit Comments --
  595.  
  596.      Shortcut key: Ins (Insert)
  597.  
  598.      This menu option is a toggle that successively enables and disables the
  599.      ability to add or edit filename comments.  When this option is enabled
  600.      there is a check mark next to the Add/Edit Comments text in the menu and
  601.      the Edit button will display as a depressed, yellow-highlighted (lit up)
  602.      button with its caption changed from "Off" to "On".  When the function is
  603.      disabled the check is removed and the Edit button returns to "Off" status.
  604.  
  605.      This function can also be invoked by selecting the Edit button in the main
  606.      menu button box.
  607.  
  608.      When Add/Edit Comments is enabled the text editing cursor will
  609.      automatically appear in the Comment window after selecting a file in the
  610.      file list window.   You can then proceed to enter and/or edit comment text. 
  611.      Use the Return key to tell DiskTrak for DOS you have finished your edit. 
  612.      When you press Return, the text in the comment window will be assigned to
  613.      the currently selected file name.   You can then proceed to select another
  614.      file name from the file list window for comment editing.
  615.  
  616.      You can delete an existing comment by deleting all its text.
  617.  
  618.      When this function is diabled it is not possible to select the comment
  619.      window, and consequently not possible to add or edit comment text. 
  620.      DiskTrak for DOS starts with this function disabled, but you can enable and
  621.      disable it whenever you like.
  622.  
  623.      Usage hint: you can invoke the Add/Edit Comment function by simply pressing
  624.      the Ins (Insert) key any time the file list window has the current focus. 
  625.  
  626.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  627.                                         12
  628.  
  629.                                   DiskTrak for DOS
  630.                                     Version 8.22
  631.  
  632.  
  633.      Doing this is quicker than selecting the Add/Edit Comment function from the
  634.      Action menu item.
  635.  
  636.  
  637.  
  638.      -- Report to Screen --
  639.  
  640.      Shortcut key: Ctrl + S
  641.  
  642.      DiskTrak for DOS can produce any of five types of reports (see the
  643.      Configuration - Report Type option below for details) summarizing its
  644.      database contents.  The Report to Screen option will report the contents of
  645.      the current database to the screen.  All of the report types except type 3
  646.      use a single window dialog box.  Report Type 3 (filenames and comments)
  647.      uses a two window dialog box: the first displays the filenames and the
  648.      first few words of the comment.  Selecting a filename with a comment in
  649.      this window will cause the entire comment text to be displayed in the lower
  650.      (second) window.  To see all the text of a very long comment, use the
  651.      scroll bars on the right of the comment text window.  
  652.  
  653.      Select the Close button at the bottom of the DiskTrak Screen Report window
  654.      to close it and return to the main menu window.
  655.  
  656.      Note: due to a Visual Basic limitation, it may not be possible for the
  657.      Report to Screen option to display all of the data in the current database. 
  658.      In this event, DiskTrak for DOS will display as much as it can, and also
  659.      issue a message indicating you should use the Report to File or Report to
  660.      Print option (described below) to obtain the entire database contents.
  661.  
  662.  
  663.      -- Report to File --
  664.  
  665.      Shortcut key: Ctrl + I
  666.  
  667.      This option directs the selected report to a disk file named <name>.RPT
  668.      (where <name> is the name of the current DiskTrak for DOS database) that is
  669.      created in the default directory.  The format of the report file is as
  670.      specified in the  Report Type option below.   This option allows you to
  671.      store the report output on disk and view it with some utility text viewing
  672.      program (or the DOS "TYPE" command), and then decide if you want to print
  673.      it by copying the file <name>..RPT to a printer.  This option creates no
  674.      printer or screen output.
  675.  
  676.  
  677.      -- Report to Print --
  678.  
  679.      Shortcut key: Ctrl + P
  680.  
  681.      This option causes DiskTrak for DOS to send its report directly to your
  682.      printer.   When you make this selection, DiskTrak for DOS directs its
  683.      report output to the device attached to your computer's LPY1 port.
  684.  
  685.  
  686.  
  687.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  688.                                         13
  689.  
  690.                                   DiskTrak for DOS
  691.                                     Version 8.22
  692.  
  693.  
  694.      -- Restore Files --
  695.  
  696.      Shortcut key: Ctrl + R
  697.  
  698.      This option allows you to select a file from the DiskTrak for DOS database
  699.      and have it copied from its diskette to a hard disk directory you specify. 
  700.      This function is typically called "restoring".
  701.        
  702.      Before selecting this function you should first select the file your want
  703.      to restore from the file list window.  Then, when you select the Restore
  704.      FIles option, DiskTrak for DOS will display a dialog window titled "Restore
  705.      from Floppy to Hard Disk".  This window identifies the name of the file
  706.      your have selected for restoring, the name of the diskette containing it,
  707.      status of the restore operation, and a drop-down drive list box and a
  708.      directory list box that allow you to select the disk and directory to which
  709.      to restore the selected file.  Finally, there is a text box that displays
  710.      the path (disk and directory) you have selected for the restore operation,
  711.      and two command buttons: Restore and Close.
  712.  
  713.      Use the drive and directory list boxes to select the restore path (remember
  714.      to double-click on the desired directory to select it.)    After selecting
  715.      the desired disk and directory, select the Restore button.  DiskTrak for
  716.      DOS will then ask if you really want to proceed with the restore operation. 
  717.      Selecting OK will allow the restore to proceed; selecting Cancel returns
  718.      you to the Restore From Floppy To Hard Disk Window.  Selecting the Close
  719.      button on the the Restore From Floppy To Hard Disk Window will close this
  720.      window and return you to the main menu window.
  721.  
  722.      Before initiating the restore function you should put the required diskette
  723.      into the Data Disk drive.
  724.  
  725.      If you select OK and initiate the restore function, DiskTrak for DOS will
  726.      attempt to copy the selected file from the diskette you have put in the
  727.      Data Disk Drive to the selected path (drive and directorty.)  Status of the
  728.      restore operation will be reflected in the Status of Restore text box and
  729.      in the main menu message window.  
  730.  
  731.      If DiskTrak for DOS is unable to locate the selected file, the message
  732.      "Can't open source or target files.  Wrong disk?" appears in the status
  733.      window.  You can then insert a different diskette (if you inadvertently
  734.      inserted the wrong one), select another file for restoring , or select the
  735.      Cancel button, which closes the "Restore from Floppy to Hard Disk" window
  736.      and returns you to the main menu window.
  737.  
  738.  
  739.      -- Delete Disks --
  740.  
  741.      Shortcut key: Del (Delete)
  742.  
  743.      This option allows you to delete one or more diskettes from the current
  744.      database.  You would want to do this if, for instance, you decided to
  745.      re-use a diskette for a different purpose and had given it a new internal
  746.      label and a new set of files.  Note that if you keep the same internal
  747.  
  748.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  749.                                         14
  750.  
  751.                                   DiskTrak for DOS
  752.                                     Version 8.22
  753.  
  754.  
  755.      diskette name (volume label) and merely replace all the files on it there
  756.      is no need to delete the diskette name from the current database.  Instead,
  757.      simply use the Add/Update function described above to "refresh" the
  758.      database with the diskette's current status.
  759.  
  760.      Selecting this option displays a warning message telling you that you have
  761.      enabled "Delete Disks" mode.  You can select OK or Cancel.  If OK is
  762.      selected, DiskTrak for DOS places a check mark next to the Delete Disks
  763.      menu text and displays a message telling you that you are in Delete Disks
  764.      mode.  From then on, each time you select a disk from the disk list window,
  765.      DiskTrak for DOS will ask you if you want to delete it from the database. 
  766.      Selecting the Yes button will delete it from the data base; selecting No
  767.      will not.  
  768.  
  769.      Return to non-Delete Disks mode by re-selecting the Delete Disks function
  770.      -- it toggles the Delete Disks mode on and off.
  771.  
  772.      Usage hint: you can invoke the Delete Disks function by simply pressing the
  773.      Del (Delete) key any time the disk list window has the current focus. 
  774.      Doing this is quicker than selecting the Delete Disks function from the
  775.      Action menu item.
  776.  
  777.  
  778.      -- Delete Files --
  779.  
  780.      Shortcut key: Del (Delete)
  781.  
  782.      This option allows you to physically delete one or more files from your
  783.      diskettes.  
  784.  
  785.      WARNING:   THE SELECTED FILES WILL ACTUALLY BE DELETED FROM YOUR DISKETTES, 
  786.      NOT SIMPLY REMOVED FROM THE DISKTRAK DATABASE.  
  787.  
  788.      This option exists to make it easy to "clean up" your diskettes; you can
  789.      easily delete unwanted and/or duplicate files using this option.  (You can
  790.      also delete files you really want to keep if you are not careful!)
  791.  
  792.      Selecting this option displays a warning message telling you that you have
  793.      enabled "Delete Files" mode.  You can select OK or Cancel.  If OK is
  794.      selected, DiskTrak for DOS places a check mark next to the Delete Files
  795.      menu text and displays a message telling you that you are in Delete Files
  796.      mode.  From then on, each time you select a file from the file list window,
  797.      DiskTrak for DOS will ask you if you want to delete the selected file. 
  798.      Selecting the Yes button will cause the program to check that the required
  799.      diskette is in the data disk drive (if not, you will be asked to insert
  800.      it), delete the specified file from it, and then automatically update the
  801.      DIskTrak data base.  Selecting No will not delete the file (and return you
  802.      to the main menu window.)  
  803.  
  804.      Return to non-Delete Files mode by re-selecting the Delete Files function
  805.      -- it toggles the Delete Disks mode on and off.
  806.  
  807.      There two major reasons why DiskTrak for DOS may not be able to actually
  808.  
  809.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  810.                                         15
  811.  
  812.                                   DiskTrak for DOS
  813.                                     Version 8.22
  814.  
  815.  
  816.      delete a selected file: (1) the file may actually not be on the diskette
  817.      (it was deleted by some other program after the diskette was added to the
  818.      DiskTrak for DOS database),  or (2) the file was found on a disk that was
  819.      write protected, and consequently could not be deleted.
  820.  
  821.  
  822.      -- Label Disks --
  823.  
  824.      Shortcut key: Ctrl + L
  825.  
  826.      This option lets you label (or re-label) a diskette from within DiskTrak
  827.      for DOS, thus eliminating the need to shell to DOS and use the DOS LABEL
  828.      command.  When you select this option DiskTrak for DOS will ask you to put
  829.      a diskette in the data disk drive.  It will then attempt to read the
  830.      internal label from the disk.  If there is no label  DiskTrak for DOS will
  831.      ask you to enter one.  If there already is a label on the disk, DiskTrak
  832.      for DOS displays a message showing the current label and asks you if you
  833.      want to re-label the disk.  If so, enter the new label.  When you have
  834.      finished labeling disks simply select the Cancel button to return to the 
  835.      main menu screen.  
  836.  
  837.      Note:  DiskTrak for DOS checks the label you enter for valid characters and
  838.      will reject one that is invalid.  DiskTrak for DOS displays an error
  839.      message in this case.  The entered label is also checked to see if it
  840.      duplicates the label of a disk in the current database.  If so, you are
  841.      queried whether or not you want to use it or enter a new one.  (Suggestion
  842.      -- use a different label to avoid duplicate diskette names.)
  843.  
  844.      Usage hint: you can invoke the  Label Disks function by simply pressing the
  845.      "L" key any time the disk list window has the current window focus.  Doing
  846.      this is quicker than selecting the Label Disks function from the Action
  847.      menu item.
  848.  
  849.  
  850.      SEARCH
  851.  
  852.      The search functions are the primary reason DiskTrak for DOS was written.
  853.        
  854.      These functions allow you to search for a particular disk volume, file
  855.      name, or file comment.  In addition, DiskTrak for DOS can identify all
  856.      duplicate files in its database.
  857.  
  858.      The disk, file, and comment search functions allow you to enter a search
  859.      argument (called the search text) consisting of a complete or partial disk
  860.      name, file name, or comment, and have DiskTrak for DOS search its entire
  861.      database for all diskettes and/or files that match your search text. When
  862.      searching, DiskTrak for DOS does not differentiate between upper and lower
  863.      case letters; they are considered the same.  Also, note that the search
  864.      functions employ literal searches based on the exact set of characters you
  865.      enter.  The special DOS wildcard characters * and ? are not recognized as
  866.      wildcards, and should not be used in the search string.
  867.  
  868.      Each of the text search functions works similarly: selecting any one
  869.  
  870.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  871.                                         16
  872.  
  873.                                   DiskTrak for DOS
  874.                                     Version 8.22
  875.  
  876.  
  877.      results in the display of a dialog box requesting entry of the search text. 
  878.      After you enter the search text and select the OK button, DiskTrak for DOS
  879.      searches the database for all matches.   While searching it displays a
  880.      message telling you how many names are being searched and what the search
  881.      text is.
  882.  
  883.      The function that searches for duplucate file names requires no input; when
  884.      selected it immediately searches the curent database for all duplicate file
  885.      names.
  886.  
  887.      When the search is finished, DiskTrak for DOS updates the disk list window
  888.      to show only those disks who match the search text (if you requested a disk
  889.      name search), or that contain files with names or comments matching the
  890.      search text (in the case of a disk name or comment search, respectively),
  891.      or that contain files with names duplicated on other disks.  Selecting one
  892.      of the disk names in the disk list window will display, in the file list
  893.      window, only those files who match the search text, or only those files
  894.      that have names the same as others.  In other words, following a search,
  895.      DiskTrak for DOS displays only the information matching the search
  896.      criteria.
  897.  
  898.      Note: After you have examined the results of your search you will want to
  899.      return to "normal mode" and enable DiskTrak for DOS to display the entire
  900.      database contents.  Use the Cancel Search Results selection to do this.
  901.  
  902.  
  903.      -- Filename --
  904.  
  905.      DiskTrak for DOS will display a dialog box asking you to enter the search
  906.      text.  The current database will then be searched for all disks containing
  907.      files whose names contain the search text.  When the search is complete
  908.      DiskTrak for DOS will display these disk names (and only these disk names)
  909.      in the disk list window.
  910.  
  911.  
  912.      -- Comment --
  913.  
  914.      DiskTrak for DOS will display a dialog box asking you to enter the search
  915.      text.  The current database will then be searched for all disks containing
  916.      files that have comments that contain the search text.  When the search is
  917.      complete DiskTrak for DOS will display these disk names (and only these
  918.      disk names) in the disk list window.
  919.  
  920.  
  921.      -- Diskname --
  922.  
  923.      DiskTrak for DOS will display a dialog box asking you to enter the search
  924.      text.  The current database will then be searched for all disks whose names
  925.      contain the search text.  When the search is complete DiskTrak for DOS will
  926.      display these disk names (and only these disk names) in the disk list
  927.      window.
  928.  
  929.  
  930.  
  931.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  932.                                         17
  933.  
  934.                                   DiskTrak for DOS
  935.                                     Version 8.22
  936.  
  937.  
  938.      -- Duplicate Files --
  939.  
  940.      When you select this function DiskTrak for DOS reads all of the file names
  941.      in the current database, sorts them alphabetically, and then searches the
  942.      names for duplicates.  When the search operation is complete, DiskTrak for
  943.      DOS shows in the disk list window only the disk names that contain
  944.      duplicate files.  Selecting one of these disk names will display in the
  945.      file list window the file names that were also found on other disks.
  946.  
  947.  
  948.      -- Cancel Search Results --
  949.  
  950.      This option cancels "search mode", which displays in the disk and file list
  951.      windows ONLY those items matching the search text, and restores "normal
  952.      mode", which allows ALL disk and file names to be displayed.
  953.  
  954.      You should be sure to select this option after reviewing the results of
  955.      your search operation so that DiskTrak for DOS can display all of the
  956.      information in the data base, and not just that that matches the seaarch
  957.      text.
  958.  
  959.  
  960.      UTILITIES
  961.  
  962.      -- Compress Data --
  963.  
  964.      Selecting this option causes DiskTrak for DOS to remove all of the unused
  965.      space from the current database.  To do this, DiskTrak for DOS creates a
  966.      new database for itself, copies all of the current database information to
  967.      it, deletes the old one, and renames the new one to the same name as the
  968.      old.  When this operation finishes there will be 0% free space in the
  969.      DiskTrak for DOS database.
  970.  
  971.      This function can also be invoked by selecting the Free: button in the main
  972.      menu button box.
  973.  
  974.      Note: in order for this function to work there must be sufficient free
  975.      space on the disk with the default directory to accommodate a second file
  976.      equal in size to the current DiskTrak for DOS database.       
  977.  
  978.  
  979.      -- Expand Data --
  980.             
  981.      Select this option if you have to add more disks to your database than it
  982.      was originally specified to hold.  After choosing this option DiskTrak for
  983.      DOS will ask you for the number of diskettes in the expanded database.  You
  984.      should enter the new TOTAL number of diskettes desired, NOT the increase
  985.      (delta) over the current number.  After entering this new total, DiskTrak
  986.      for DOS will create a database capable of holding the specified number of
  987.      disks, and will then copy all of the data in your current database to the
  988.      newly expanded one.  When this is complete, DiskTrak for DOS will delete
  989.      your current database and rename the new one to your "old" current database
  990.      name.  The new, expanded database will also be compressed, i. e., it will
  991.  
  992.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  993.                                         18
  994.  
  995.                                   DiskTrak for DOS
  996.                                     Version 8.22
  997.  
  998.  
  999.      have 0% free space. 
  1000.  
  1001.      This function can also be invoked by selecting the button showing the
  1002.      current maximum number of diskettes in the main menu button box.
  1003.  
  1004.  
  1005.      -- Make a Database --
  1006.             
  1007.      Use this option to create your own DiskTrak for DOS database(s).  You can
  1008.      have any number of databases, but only one can be in use at a time. 
  1009.      Multiple databases may be desired, for instance, if there are several
  1010.      people using your computer and each has his/her own set of diskettes.  Or,
  1011.      you may have so many diskettes that you want to logically segregate them
  1012.      into groups.
  1013.             
  1014.      To create a DiskTrak for DOS database, select this option and specify the
  1015.      name of the database and the number of diskettes you want it to hold.  When
  1016.      specifying the database name, enter only the 1 to 8 character primary
  1017.      extension.  (Because all DiskTrak for DOS databases must have a name of the
  1018.      form <name>.DTW, DiskTrak for DOS will automatically add the extension
  1019.      ".DTW" to the name you enter.)  When specifying the number of diskettes the
  1020.      database should hold, enter a reasonable number.  You can always increase
  1021.      it later by using the Expand function described above.
  1022.  
  1023.      After specifying the database name and number of diskettes it is to hold,
  1024.      select the OK button to cause DiskTrak for DOS to create the database. 
  1025.      Select the Cancel button to cancel this fiunction and return to the main
  1026.      program window with no action.
  1027.  
  1028.      The database created by this option will (obviously) be empty.  Add
  1029.      diskettes to it by first selecting the new database  by using the File -
  1030.      Open a Database function, and then invoking the Action - Add/Update Disk
  1031.      option.
  1032.  
  1033.      Note: since there is no way to reduce the size of a DiskTrak for DOS
  1034.      database you should avoid specifying a total number of disks significantly
  1035.      larger than you are likely to need.  You can always expand your database
  1036.      later.
  1037.  
  1038.  
  1039.      -- Sort Disknames by Name --
  1040.  
  1041.      Shortcut key: Ctrl + N
  1042.  
  1043.      In general, DiskTrak for DOS displays diskettes entered into its database
  1044.      in the order in which they are entered.  The Sort Disknames by Name option
  1045.      lets you change the order of the display to alphabetical.  New diskettes
  1046.      will continue to be added in the order entered, and will not be listed in
  1047.      alphabetical order unless you re-sort the entire list of names using this
  1048.      option.
  1049.  
  1050.  
  1051.  
  1052.  
  1053.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  1054.                                         19
  1055.  
  1056.                                   DiskTrak for DOS
  1057.                                     Version 8.22
  1058.  
  1059.  
  1060.      -- Sort Disknames by Free Space --
  1061.  
  1062.      Shortcut key: Ctrl + F
  1063.  
  1064.      This option is similar to the above one, except the list of disks is sorted
  1065.      by available free space.  The disk with the least free space is listed
  1066.      first.  Disks with unknown free space (showing "?K") are listed last; these
  1067.      are disks from a database that was copied from a DOS DISKTRAK.EXE
  1068.      <name>.DT7 database and that have not yet been entered into the current
  1069.      database by this version of DiskTrak for DOS.
  1070.  
  1071.  
  1072.      -- Show Free Space --
  1073.  
  1074.      This option shows you the amount of free space on a diskette.  After
  1075.      selecting this option DiskTrak for DOS will ask you to insert a diskette
  1076.      into the Data Disk Drive.  After doing so, select the OK button and
  1077.      DiskTrak for DOS will read the label of the diskette, determine its total
  1078.      free space (in K bytes, where K = 1000) and display a message containing
  1079.      this information.  DiskTrak for DOS will then repeat this process until you
  1080.      select the Cancel button to return to the main menu.
  1081.  
  1082.  
  1083.      CONFIGURATION
  1084.  
  1085.      Selecting this menu item displays a dialog window that allows you to view,
  1086.      change, and save DiskTrak for DOS' configuration items.  The following
  1087.      paragraphs describe the selectable items in the Configuration dialog
  1088.      window.
  1089.  
  1090.      -- OK --
  1091.  
  1092.      Retains the currently set configuration items, closes the Configuration
  1093.      window, and returns you to DiskTrak for DOS' main program window.  If you
  1094.      changed any of the configuration items they will be in effect for your
  1095.      current session only; you must select the Save button below to make them
  1096.      permanent.
  1097.  
  1098.      -- Save --
  1099.  
  1100.      This button creates (if it does not already exist) or updates (if it does
  1101.      exist) a file in the default directory called DISKTRKD.CFG and writes into
  1102.      it all of the current DiskTrak for DOS configuration parameters.  These
  1103.      parameters include the current color specifications, the DiskTrak for DOS
  1104.      database name, the diskette drive to use when reading diskettes, the number
  1105.      of lines per report page, the desired report type, and the ZIP status
  1106.      (enabled or disabled).  
  1107.  
  1108.      You should use this function to retain any new or changed program settings
  1109.      from one session to the next.
  1110.  
  1111.  
  1112.      -- Data Disk Drive --
  1113.  
  1114.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  1115.                                         20
  1116.  
  1117.                                   DiskTrak for DOS
  1118.                                     Version 8.22
  1119.  
  1120.  
  1121.      This option allows you to specify the diskette drive DiskTrak for DOS will
  1122.      use for reading diskettes.  The default diskette drive is A:, but you can
  1123.      change it to any drive letter A: through P:.  DiskTrak for DOS will reject
  1124.      a drive "letter" that is not a character in the range A -- P.  You can
  1125.      enter either an upper or lower case letter (no colon).        
  1126.  
  1127.      You can also change the data disk drive by selecting the Data Drive: 
  1128.      button in the main menu button box.  Selecting this button with the left
  1129.      mouse button increases the drive letter by one; selecting with the right
  1130.      button decreases it by one.
  1131.  
  1132.  
  1133.      -- ZIP Extract --
  1134.  
  1135.      This option lets you specify whether or not DiskTrak for DOS is to extract
  1136.      the names of files stored inside an archive file of type ZIP, ARC, PAK,
  1137.      LZH, or ZOO.  The default is NOT to do this.  If you select this option the
  1138.      ZIP button will display as a depressed, yellow-highlighted (lit up) button,
  1139.      and its caption will change from "No" to "Yes".  DiskTrak for DOS will then
  1140.      add to its database, in addition to the base ZIP, ARC, PAK, LZH, or ZOO
  1141.      archive file name, all of the file names contained inside each one.  Note
  1142.      that if you enable this function and then add to the DiskTrak for DOS
  1143.      database one or more disks containing numerous archive files, the size of
  1144.      your database will get very large very quickly.
  1145.  
  1146.      To turn the ZIP option off, simply reselect it; it is a "toggle."  This
  1147.      function can also be invoked by selecting the ZIP: button in the main menu
  1148.      button box.
  1149.  
  1150.      The "ZIP" status is saved in the DiskTrak for DOS DISKTRKW.CFG file, so if
  1151.      you want it always enabled, enable it and then select the Save button.
  1152.  
  1153.  
  1154.      -- Print Lines/Page --
  1155.  
  1156.      This option lets you specify the number of lines DiskTrak for DOS will
  1157.      place on its output reports.  These reports can be sent either directly to
  1158.      your printer or to a disk file: see the Action -- Report  options above. 
  1159.      Because of the title and page number lines DiskTrak for DOS prints on each
  1160.      report page, the number of lines per page must be at least 7.  The Print
  1161.      Lines/Page option has no effect on reports directed to the screen.  You can
  1162.      retain the number you specify in the DISKTRKW.CFG configuration file (make
  1163.      it permanent) by selecting the Save button.
  1164.  
  1165.  
  1166.      -- Report Type --
  1167.  
  1168.      DiskTrak for DOS can create five types of reports that summarize the
  1169.      information in its database.  Report type 1 lists all files in the database
  1170.      and the diskette name each file is on, sorted alphabetically by filename. 
  1171.      Report type 2 contains the same information, but sorts it by diskette
  1172.      volume name.  Report type 3 lists every filename and its comment (if
  1173.      present); this report is sorted by filename.  Report type 4 lists each disk
  1174.  
  1175.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  1176.                                         21
  1177.  
  1178.                                   DiskTrak for DOS
  1179.                                     Version 8.22
  1180.  
  1181.  
  1182.      and its free space, sorted by disk name.  Report type 5 is like type 4,
  1183.      except the sort is by amount of free space.
  1184.  
  1185.      Specify the desired Report Type by selecting the appropriate button.  The
  1186.      selected button will have a yellow background color. You can retain the
  1187.      selected report type by selecting the Save button.
  1188.  
  1189.      -- Screen Colors --
  1190.             
  1191.      This command button lets you set the window and dialog box colors for
  1192.      DiskTrak for DOS.  When you select this button, DiskTrak for DOS
  1193.      temporarily hides the Configuration dialog window and displays the color
  1194.      control window.  This window contains a set of color controls, a sample
  1195.      color area, a "model" of the DiskTrak for DOS main screen, a series of
  1196.      "radio buttons" allowing you to select the window element(s) for which you
  1197.      want to set the colors, and two command buttons that let you apply the new
  1198.      colors and return to the Configuration dialog window.  To set colors, use
  1199.      the following steps:
  1200.  
  1201.      (1)  Use the "Select Screen Element..." radio buttons to select the screen
  1202.      element you want to alter.  Note that the selected item's name is reflected
  1203.      in the "Now setting colors for" text window.
  1204.  
  1205.      (2)  Use the "Foreground/Background" radio buttons to specify whether you
  1206.      are about to set the foreground (text) color or background color. 
  1207.      Suggestion: set the background color first, then the foreground color.
  1208.  
  1209.      (3)  Use the arrow keys (or mouse) to choose from the color matrix of  the
  1210.      standard DOS pallette of 16 colors the color you want the previously
  1211.      selected screen element to have.  As you choose different colors from the
  1212.      matrix the color of the small window immediately above the color matrix
  1213.      will change to reflect the current color matrix selection.
  1214.  
  1215.      (4)  When you have established the desired color, select the OK button. 
  1216.      This will apply the color to the previously selected screen element.  The
  1217.      appropriate color in the "model" window in the upper right corner will
  1218.      change to reflect the new color scheme.  This action also changes the
  1219.      "real" screen elements.
  1220.  
  1221.      (5)  Repeat steps (1) -- (4) until all the screen elements are colored they
  1222.      way you want them.
  1223.  
  1224.      (6)  Select the Close button to close the color setting window and return
  1225.      to the Configuration dialog window.
  1226.  
  1227.      Note: your new color scheme will only be in effect for your current session
  1228.      and will NOT be retained permanently UNLESS you perform a Configuration
  1229.      Save function by selecting the Configuration menu's Save button
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  1237.                                         22
  1238.  
  1239.                                   DiskTrak for DOS
  1240.                                     Version 8.22
  1241.  
  1242.  
  1243.      HELP
  1244.  
  1245.      -- Help --
  1246.  
  1247.      Selecting Help will display a two-window dialog box that contains an index
  1248.      of Help topics on the left and Help text on the right.  Selecting a topic
  1249.      causes the text for that topic to display at the top of the text window. 
  1250.      You can scroll through either the index or text window using the scroll
  1251.      bars, PgUp/PgDn keys, arrow keys, etc.  When you have finished reading the
  1252.      Help text, select the Return to DiskTrak button to close the Help dialog
  1253.      box.
  1254.  
  1255.  
  1256.      -- About --
  1257.  
  1258.      If you are using a non-registered copy of DiskTrak for DOS, selecting this
  1259.      option displays a "Registration Motivator" dialog box that requires you to
  1260.      enter the word "register".  After doing so, a message window is displayed
  1261.      giving some information about the program and how to contact the program
  1262.      author.
  1263.  
  1264.      If you are using a registered version of the program, the "Registration
  1265.      Motivator" dialog box does not appear, and the message window displays the
  1266.      name of the person to whom the program is registered, along with the other
  1267.      program related information.
  1268.  
  1269.  
  1270.                                  Future Enhancements
  1271.  
  1272.      Additional enhancements will be developed depending on the degree of
  1273.      interest and support received by the current version of DiskTrak for DOS. 
  1274.      Peninsula Software will seriously consider any enhancements suggested by
  1275.      registered users.  For example, the report option was added as a result of
  1276.      a suggestion (and sample source code) from Joseph R. Nelis, Jr. (thanks,
  1277.      Jody!) and the comments option resulted from a suggestion by L. P.
  1278.      Thomason.  
  1279.  
  1280.  
  1281.                             The DiskTrak for DOS Database
  1282.  
  1283.      The distribution DiskTrak for DOS files contain a "sample" database called
  1284.      SAMPLE.DTW.   This database contains information from a small set of disks
  1285.      and includes comments containing helpful information about using DiskTrak
  1286.      for DOS.  When DiskTrak for DOS starts, it first checks to see if a
  1287.      configuration file exists.  (See above section CONFIGURATION --
  1288.      Configuration Save for more information on creating the configuration
  1289.      file.)  If there is a configuration file, DiskTrak for DOS attempts to use
  1290.      the database defined in it.  If there is no configuration file, DiskTrak
  1291.      for DOS attempts to use a database called SAMPLE.DTW.  In either case, if
  1292.      DiskTrak for DOS cannot open or read the database file, it returns to the
  1293.      main menu with an error message stating it was unable to access the
  1294.      selected database and requests you to select a different one.
  1295.  
  1296.  
  1297.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  1298.                                         23
  1299.  
  1300.                                   DiskTrak for DOS
  1301.                                     Version 8.22
  1302.  
  1303.  
  1304.      The DiskTrak for DOS database contains the names of all the diskettes you
  1305.      have entered, the amount of free space on each, all of the file names on
  1306.      all diskettes, and all of the comments you enter.  Beginning with Version
  1307.      8.00, the database was enhanced to also contain date and time stamp data
  1308.      for each file, and the name of the diskette directory containing each file. 
  1309.      There are pointers in the database that connect a diskette to its files,
  1310.      and files to their comments (if present).  Finally, there are  counters
  1311.      holding the total number of diskettes in the database, the number of "free"
  1312.      file names, and the number of "free" comment characters.  "Free" filenames
  1313.      result from files being deleted from diskettes, or from diskettes being
  1314.      deleted from the database.  "Free" comment bytes result from files with
  1315.      comments being deleted from the database, or by creating new (edited)
  1316.      comments that are longer than the original comment.
  1317.  
  1318.      The latter two numbers are what determine the "free space" in the data
  1319.      base.  Free space results from deleting a diskette from the database, or
  1320.      from "refreshing" a diskette already existing in the database.  In either
  1321.      of these two cases, the filenames previously used are flagged as "free" and
  1322.      are no longer usable.  (Comments are maintained intact, however, if the
  1323.      filename with the comment is still on the updated disk.)  All updates
  1324.      and/or additions to the database are made at the end of the database. 
  1325.      Consequently, as time goes on, unwanted "free space" will build up inside
  1326.      the database.  This "free space" is reported in the DiskTrak for DOS
  1327.      program information window in terms of a percentage of the size of the
  1328.      entire database.  This "free space" is literally unusable, wasted space and
  1329.      should be eliminated when it becomes excessive.
  1330.             
  1331.      The "Compress Data" option under the Utilities selection will eliminate all
  1332.      "free space" from your database.  See the section describing that option
  1333.      for more detail.
  1334.  
  1335.  
  1336.                                    Version History
  1337.  
  1338.      Version 8.00
  1339.  
  1340.      Version 8.00 is the initial release of DiskTrak for DOS that is based on
  1341.      Peninsula Software's DiskTrak for Windows.  There were many earlier
  1342.      versions of DiskTrak for DOS, the last of which, version 7.40, was the
  1343.      basis for the first version of DiskTrak for Windows.  Following the release
  1344.      of DiskTrak for Windows, no further development was done on DiskTrak for
  1345.      DOS.  Instead, all new features were developed for DiskTrak for Windows. 
  1346.      When Microsoft released the Visual Basic for DOS compiler (September 1992)
  1347.      DiskTrak for Windows had evolved to a much more capable program than
  1348.      DiskTrak for DOS.  Hence the most effective approach for enhancing DiskTrak
  1349.      for DOS was to convert the Windows version to DOS.  Visual Basic for DOS
  1350.      enabled this to occur, and the result became DiskTrak for DOS Version 8.00.
  1351.  
  1352.      Version 8.10
  1353.  
  1354.      Corrected obscure bug that sometimes caused DiskTrak to not recognize a
  1355.      Version 7.xx database and hence caused the old format database to not get
  1356.      converted to the new format.  This, in turn, caused many bad things to
  1357.  
  1358.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  1359.                                         24
  1360.  
  1361.                                   DiskTrak for DOS
  1362.                                     Version 8.22
  1363.  
  1364.  
  1365.      happen when the program tried to access the un-converted database.  Thanks
  1366.      to John Rich for reporting this and sending a copy of his Version 7.xx
  1367.      database for debugging purposes.
  1368.  
  1369.      Corrected incorrect default main menu foreground color (black, rather than
  1370.      yellow), thus eliminating the incorrect resetting of the main menu
  1371.      foreground color to black after the first use of the Configuration Save
  1372.      function.  Thanks to John Rich for reporting this bug also.
  1373.  
  1374.      Version 8.20
  1375.  
  1376.      Corrected bug that prevented DiskTrak from accessing archive files in
  1377.      diskette subdirectories when the ZIP function was enabled.  More thanks to
  1378.      John Rich for reporting this bug.
  1379.  
  1380.      Corrected formatting for print and file report types 3 and 4.
  1381.  
  1382.      Changed internal program structure to allow maximum RAM usage for database
  1383.      data and eliminate the Visual Basic for DOS default restriction of 64K for
  1384.      data.  Related to this, reworded the paragraph in this documenmt describing
  1385.      memory limitations and added additional program checking for out-of-memory
  1386.      conditions and the display of corresponding error messages.
  1387.  
  1388.      Version 8.21
  1389.  
  1390.      Added code to allow the Database Compress function to operate properly when
  1391.      Search Mode is enabled, and to ensure Search Mode is not enabled when
  1392.      editing comments.  Thanks to John Rich for suggesting these changes.
  1393.  
  1394.      Added code to prevent a program failure when using one of the Search
  1395.      functions for a database containing only one disk.  Thanks to John Rich for
  1396.      reporting this problem.
  1397.  
  1398.      Version 8.22
  1399.  
  1400.      Corrected problem causing program crash when unable to delete a file from a
  1401.      diskette.  More thanks to John Rich for reporting this bug.
  1402.  
  1403.  
  1404.                          Potential Future Enhancements
  1405.  
  1406.      The ability to produce an unformatted disk file report containing only the
  1407.      current database's disk names (thus allowing file input to a disk label
  1408.      printing program), and an unformatted disk file report containing all of
  1409.      the filenames, dates, and times (thus allowing file input into a database
  1410.      program.)
  1411.  
  1412.      Providing an install program like the installation programs accompanying
  1413.      major commercial DOS applications.  
  1414.  
  1415.      Optional automatic naming of unlabelled diskettes using a user defined
  1416.      "base" name that is incremented by the program
  1417.  
  1418.  
  1419.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  1420.                                         25
  1421.  
  1422.                                   DiskTrak for DOS
  1423.                                     Version 8.22
  1424.  
  1425.  
  1426.      Availabilty of shortcut keys for more program functions.
  1427.  
  1428.      If you have comments or suggestions about these (or other) enhancements to
  1429.      DiskTrak for DOS, please send them to:
  1430.  
  1431.                           Birk Binnard
  1432.                           Peninsula Software
  1433.                           28510 Bluythewood Drive
  1434.                           Palos Verdes CA 90274
  1435.  
  1436.      or send a Compuserve E-Mail letter to 72356,556.
  1437.  
  1438.  
  1439.                           Un-Planned Enhancements
  1440.  
  1441.      (In other words, these are suggestions I have received but have no plans to
  1442.      implement.)
  1443.  
  1444.      Diskette label printing (i. e., including a function that prints diskette
  1445.      volume labels on a printer into which you have put diskette label paper
  1446.      stock.)
  1447.  
  1448.      "Automatic" import of comments stored in a file by some other piece of
  1449.      software.
  1450.  
  1451.      Including file size in the database.
  1452.  
  1453.      Changing the Registration Motivator to require less user interaction.
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.         Peninsula Software -- 28510 Blythewood Drive -- Palos Verdes CA -- 90274
  1481.                                         26